home *** CD-ROM | disk | FTP | other *** search
/ Amiga Packmags / NewsFlash - Issue 07 (1990-01)(UGA - 17-Bit Software)(Disk 1 of 2)[a].zip / NewsFlash - Issue 07 (1990-01)(UGA - 17-Bit Software)(Disk 1 of 2)[a].adf / doc / DISCTUTORIAL.doc < prev    next >
Text File  |  1988-01-19  |  18KB  |  434 lines

  1. -----------------------------------------------------------------------------
  2.  
  3.    -->  Help/Hints for creating a disc that will autoboot and run a  <--
  4.         program of your choice.. eg a Ghostwriter/Spacewriter demo.
  5.  
  6.    A walk-thru guide, much like a cookery book! Heres one I did earlier!!
  7.  
  8. -----------------------------------------------------------------------------
  9.  
  10. This is an area where we get many cries for help and hopefull this article
  11. should guide you through all the options and procedures...
  12.  
  13. This tutorial covers formatting options, formatting, copying workbench,
  14. renaming files, deleting items, creating a 'shell' disc to work from,
  15. makeing new directories, using ram discs, speeding up DOS operations,
  16. initializing, what files/draws are needed and startup-sequences..
  17.  
  18.                            FIRST THINGS FIRST...
  19.                            ------------------
  20. You will need a disc to work on, you can do two things you can..
  21.  
  22. Either FORMAT/Initialise a disc from scratch 
  23. or     Delete all items from a copy of Workbench that you will not use.
  24.  
  25. AS A BEGINNER YOU MAY WANT TO FOLLOW EITHER PATH, BUT I WOULD SAY THAT 
  26. USING A PARTIALLY DELETED WORKBENCH DISC IS THE EASIEST OPTION..
  27.  
  28. -----------------------------------------------------------------------------
  29.  
  30. HINT!                   ** HOW TO ACCESS THE CLI **
  31.  
  32. This tutorial will guide you through CLI usage and show you what can be done
  33. hopefully it will encourage you to use it a bit more. I accept that the 
  34. manual isnt exactly helpful but never mind.
  35.  
  36. To actually get the CLI up and running from Workbench, open the SYSTEMS draw
  37. and it should be in there (1.3 owners will see SHELL - open that).
  38. A rectangle box about 1/4 the size of the screen appears and you can move/
  39. stretch this as you feel necessary. You will see a '1>' prompt...
  40.  
  41. The '1>' means it is the first CLI (you can have quite a few going at once
  42. you see, but we only need 1 for what we are doing here) and the '>' sign
  43. means that it is ready for some input.
  44.  
  45. To close the CLI window at anytime and return to workbench type 'ENDCLI'.
  46.  
  47. -----------------------------------------------------------------------------
  48.  
  49. HINT!                   ** SPEEDING THINGS UP! **
  50.  
  51. Using Amigados can be a real pain so how can things be speeded up? Well one
  52. option is to put all the most popular CLI commands into a RAM: disc and 
  53. run them from there. [A ram disc acts just like a normal disk drive but is
  54. stored in memory and all data is lost when you turn off].
  55.  
  56. To create a faster environment to work in... load up workbench and open
  57. the CLI icon (may also be called SHELL - its in the system drawer remember)
  58. once the CLI window appears.. type..
  59.  
  60. copy c/run to ram:
  61. copy c/type to ram:
  62. copy c/execute to ram:
  63. copy c/dir to ram:
  64. copy c/copy to ram:
  65. copy c/delete to ram:
  66. copy c/assign to ram:
  67. copy c/cd to ram:
  68. copy c/list to ram:
  69. copy c/loadwb to ram:
  70. copy c/endcli to ram:
  71. copy c/setmap to ram:
  72. copy c/makedir to ram:
  73. copy c/install to ram:
  74. copy c/ed to ram:
  75.  
  76. THIS PUTS THE MOST COMMONLY USED CLI COMMANDS IN THE RAM: DISC.. if you are
  77. curious, type 'list ram:' and there they all are! They havent moved from
  78. the original disc, these are copies.
  79.  
  80. Now just type 'assign c: ram:' - this makes the amiga look for the 
  81. commands in the C directory in the ramdisc... so instead of loading it
  82. from disc it just runs from memory! saves a lot of time and disc-swapping
  83. later on..
  84.  
  85. -----------------------------------------------------------------------------
  86.  
  87. If you intend to use a copy of workbench instead of a new disc goto 1.1
  88.  
  89. 1.Formatting:
  90. -------------
  91. If you do not have a dedicated formatting utility then the Workbench 
  92. initializing command will be ok. Load up workbench in the standard way
  93. and when the workbench appears insert the disc you would like to format
  94. in the drive.
  95.  
  96. If the disc is unformatted - or has an unreadable format then the name of
  97. the disc will be DF0:BAD or DF0:NDOS (if its a strange format).
  98.  
  99. If the disc has data on it, the name of the disc will appear - MAKE SURE
  100. YOU REALLY WANT TO FORMAT AS ALL PREVIOUS CONTENTS WILL BE LOST!
  101.  
  102. When you are happy that you arent going to lose anything major (something
  103. like Streetfighter will do ok! hehe) then click on the disc icon to 
  104. highlight it, and access the menus at the top and select INITIALIZE.
  105.  
  106. The Amiga will respond with 'DF0:BUSY' and a counter showing what track is
  107. currently being formatted. If the format fails try another disc as it is
  108. likely that the disc is damaged although this is a rare occurance.
  109.  
  110. Once formatted the disc will be called blank (this means the name in amiga
  111. dos will be Blank:) the colon (:) signifies that it is a device, otherwise
  112. Blank could be just a drawer or a program or filename.
  113.  
  114. ----------------------------------------------------------------------------
  115. HINT!  ** NAMING OF DISCS, WHY IT IS IMPORTANT AND WHAT IT ALLOWS **
  116.  
  117. In amigados (CLI) you can now use the disc just like you would use
  118. a ram: disc, external disc (df1:) or (df0:) by using 'blank:'. 
  119.  
  120. Eg You are using workbench and you are in CLI, you want to copy a file 
  121. called DATA to your own disc, how do you do this with one drive? Easy..
  122.  
  123. Just type 'Copy data to blank:' - this will move the file called DATA to
  124. the disc called blank. Of course you can substitute the names of the 
  125. files and discs to suit yourself..
  126.  
  127. More complex example..
  128.  
  129. Imagine you have a program called ACCOUNTS and it is on a disc called UTILS
  130. and in a drawer called PROGRAMS - you would like to move this program to a
  131. disc of your own called MYDISC and into a drawer you have made called 
  132. MYPROGRAMS.
  133.  
  134. You would use the following from CLI.. 'Copy utils:programs/accounts to 
  135.                                         mydisc:myprograms'
  136.  
  137. Note the use of the '/' character which means a sub-directory...
  138.  
  139. Sub-Directories are draws within draws..  EG on your workbench you have
  140. a drawer called DEVS and inside devs you have several more draws, for
  141. printers, keymaps etc - these are sub-draws.. to list them from CLI
  142. you could type 'Dir devs/printers' - this lists the contents of the
  143. draw printers which is in the draw called devs. To get clever you could
  144. also add a device name! Then you could choose which DISC to look at as well,
  145. so you could examine DF0: (internal drive) DF1: (external drive) RAM:
  146. (Ram-disc) DATA: (a disc with the name data) etc 
  147. ----------------------------------------------------------------------------
  148. HINT!          ** CHOOSE A NAME FOR THE DISC AND REMEMBER IT **
  149.  
  150. If you have just one drive you may find it wise to rename the disc to 
  151. something which is easily remembered - like DEMO or whatever you like, the
  152. workbench disc is (funnily enough) called Workbench. DO TRY and avoid using
  153. spaces in the name as this will only add to confusion! If you need spaces
  154. then use the '-' sign as a seperator as in 'Demo-Disc'.
  155.  
  156. WHY SHOULDNT I USE SPACES?? Well, because of the way Amigados works a space
  157. is taken as a 'seperator'  eg if from CLI you try and run a program you 
  158. have got that is called 'MY DEMO' it will try and run a program called 'MY'
  159. and will report an error.
  160.  
  161. If however you used "MY DEMO" it would work, as the quotes mean it is one
  162. word... yes it is confusing so AVOID the spaces ok?
  163.  
  164. FOR THE TUTORIAL I ASSUME YOU NAME A DISC 'DEMO' SO PLEASE USE THIS NAME
  165. IF POSSIBLE OR SUBSTITUTE 'DEMO' FOR YOUR OWN DISC-NAME...
  166. -----------------------------------------------------------------------------
  167. HINT!                    ** HOW TO RE-NAME A DISC **
  168.  
  169. This is a relatively simple thing to do, when the workbench is active, enter
  170. the disc you are to be renaming and the icon for the disc should appear.
  171.  
  172. Click on the disc so that it is highlighted and select RENAME from the options
  173. at the top-menus. A space will appear where you can delete the old name
  174. and type the new one. Make sure the disc is write-enabled so the data can
  175. be saved though! Easy huh!?
  176. -----------------------------------------------------------------------------
  177.  
  178. If you have successfully formatted and named a disc to your satisfaction then
  179. go to step 2.. If you would like to try the other method of deleting what you
  180. dont need from a copy of workbench then follow the steps below...
  181.  
  182.  
  183.  
  184. 1.1 CREATING A WORKABLE DISC FROM A COPY OF WORKBENCH
  185. -----------------------------------------------------
  186. First you have to get a copy, you can do this by using a commercial copy 
  187. program/utility or via workbench. Follow the programs instructions if you
  188. are using a commercial program or the ones below to copy using Workbench.
  189.  
  190. Copying on workbench
  191. --------------------
  192. Whilst on workbench, highlight the workbench icon by clicking on it and 
  193. select duplicate from the menus at the top. Follow the prompts as shown
  194. and a couple of minutes later you will have a copy. Note: You do NOT need
  195. a formatted disc, the amiga will do this for you.. if you have just one
  196. drive you will have to do a fair bit of swapping.
  197.  
  198. When complete you will have a disc called 'Copy Of Workbench'.. 
  199. ----------------------------------------------------------------------------
  200. HINT!                       ** BE CAREFUL ! ** 
  201.  
  202. After copying a disc through workbench the disc-name has 'Copy Of'
  203. added to it, you may find certain discs will not work due to the name being
  204. different... you can easily remedy this by using the RENAME option as used
  205. earlier.. simply delete the 'Copy of' and also the leading space. You will
  206. find it easier to rename it to something which you can easily remember.
  207. ----------------------------------------------------------------------------
  208.  
  209. Deleting the Files you will not need...
  210. ---------------------------------------
  211. Ok, so you have a copy of workbench, what do you do now? Well provided you
  212. have renamed the disc to something suitable.. I will assume you have named
  213. it 'DEMO'
  214.  
  215. Firstly while you have workbench loaded up, put the disc you are going to
  216. be working on in the internal drive (df0:) which should be called DEMO or
  217. whatever name you have given it. Double click on its icon to open the
  218. main directory.
  219.  
  220. Now delete each of the items on there by first highlighting them (click
  221. on the item once) and then select DISCARD from the menu at the top.
  222. Repeat until all of the files have disappeared and there is only the 
  223. trashcan left.
  224.  
  225. Insert your workbench disc back into the drive and open the CLI icon
  226. again (inside the System drawer).
  227.  
  228. type the following..
  229.  
  230. delete demo:fonts all           <- this deletes firstly all the files in side
  231.                        a drawer called FONTS on a disc called
  232.                                    DEMO then deletes the drawer itself.
  233.  
  234. delete demo:devs/keymaps all    <- this gets rid of the keymaps
  235.  
  236. delete demo:devs/clipboards all <- likewise the clipboards
  237.  
  238. delete demo:s                   <- Empties the S Directory
  239.  
  240. FOLLOW ALL PROMPTS/DISC SWAPS AS REQUIRED {QUITE A FEW IF YOU ONLY HAVE 1
  241. DRIVE!}
  242.  
  243. If you are not using a ram: disc to store all your Cli commands then you 
  244. need to type all of the following...
  245.  
  246. copy c/run to ram:
  247. copy c/type to ram:
  248. copy c/execute to ram:
  249. copy c/dir to ram:
  250. copy c/copy to ram:
  251. copy c/delete to ram:
  252. copy c/assign to ram:
  253. copy c/cd to ram:
  254. copy c/list to ram:
  255. copy c/loadwb to ram:
  256. copy c/endcli to ram:
  257. copy c/setmap to ram:
  258. copy c/makedir to ram:
  259. copy c/install to ram:
  260. copy c/ed to ram:
  261.  
  262. THIS PUTS THE MOST COMMONLY USED CLI COMMANDS IN THE RAM: DISC.. if you are
  263. curious, type 'list ram:' and there they all are! They havent moved from
  264. the original disc, these are copies.
  265.  
  266. Now type...
  267.  
  268. delete demo:c all  <- this deletes all the CLI commands and directory
  269.               dont panic as we have the ones we are interested
  270.                       tucked away in ram:
  271.  
  272. ------------------------------------------------------------------------------
  273.  
  274. makedir demo:c     <- this creates a drawer (or directory) on your disc 
  275.                       called C, it is the place where the Amiga looks for
  276.                       the [C]ommands.
  277.  
  278. Now we want to put the commands into the empty directory from the ram disc
  279. using the copy command.. so type..
  280.  
  281. copy ram: to demo:c all <- and this does the trick!
  282.  
  283. Now you have your commands on your disc (just the ones you will need later).
  284.  
  285. -----------------------------------------------------------------------------
  286.  
  287. 2. Moving on...
  288.  
  289. By now you will have either...
  290.  
  291. 1)    A freshly formatted disc with a directory called 'C' containing
  292.     the most popular Cli commands
  293.  
  294. 2)    A renamed copy of workbench with about 80% space on it..
  295.  
  296. If you have (1) then do the following...
  297.  
  298. 'Copy devs: to demo:'
  299. 'Copy l: to demo:'
  300. 'Copy libs: to demo:'
  301.  
  302. After this has finished - type...
  303.  
  304. 'delete demo:devs/keymaps all'    <- this gets rid of the keymaps
  305.  
  306. 'delete demo:devs/clipboards all' <- likewise the clipboards
  307.  
  308. ----------------------------------------------------------------------------
  309. You will now have a disc named DEMO with about 80% space on it..
  310.  
  311. If you put all the CLI commands into a ramdisc earlier on you can place the
  312. disc called DEMO in the drive and type INSTALL df0: 
  313. This makes the disc bootable.
  314.  
  315. HINT!!
  316. If you are not using a ramdisc, you can make a disc bootable by following
  317. these commands...
  318.                 'Copy c:install to ram:'
  319.                 NOW INSERT THE DISC TO INSTALL (DEMO or other name)
  320.                 'ram:install df0'
  321. -----------------------------------------------------------------------------
  322. Now type MAKEDIR demo:s  <- creates a drawer for your Scripts/Sequences
  323.  
  324. You are now ready to put the programs that you want onto the disc and
  325. prepare the startup-sequence ready to create a working disc for use!
  326.  
  327. HINT!                MAKE A COPY !!! SO YOU DO NOT HAVE TO DO
  328.                                THIS ALL THE TIME!!!
  329. ----------------------------------------------------------------------------
  330. 3. An example.
  331. --------------
  332. You have created an intro with Spacewriter/Ghostwriter and you would like
  333. to put it on a disc for a friend.
  334.  
  335. 1) You need to copy the intro program you have created, lets say for
  336. example its called INTRO - you could copy it to ram: through the CLI as
  337. you should have now learnt and then onto the destination disc, as we have
  338. been doing through this tutorial.
  339.  
  340. 2) Once it is on the disc a STARTUP-SEQUENCE needs to be created!
  341.  
  342.  
  343. 3.1 WHAT IS THE STARTUP-SEQUENCE AND HOW IT IS EDITED....
  344. ---------------------------------------------------------
  345.  
  346. The startup-sequence is a file that reads rather like a basic program,
  347. it contains a list of commands that are executed (or run) by the Amiga
  348. one after another.
  349.  
  350. For example a startup-sequence might look like this..
  351.  
  352. echo "Hello There"
  353. loadwb
  354. endcli
  355.  
  356. What this does is first to print 'Hello There' on the screen (the command
  357. is called Echo - echo to the screen), then load the Workbench system and
  358. then close the CLI by using the command ENDCLI. Result is that the Amiga
  359. ends up on workbench ready to use. This would be a good example to use if
  360. you are wanting to put programs on a workbench disc that runs straight
  361. away without the use of another workbench disc.
  362.  
  363. As you can see the Amiga reads the first command, follows it and then gets
  364. the next etc... the startup-sequence can be any length.
  365.  
  366. The amiga goes through this sequence when booting...
  367.  
  368.    Checks its systems and depending upon the condition of the Amiga it
  369.    makes the screen go a different colour, normal is white/grey, if your
  370.    screen goes red/green EVERY time when you switch on there may be a
  371.    problem and it could pay to have it checked out.. Occaisional colours are
  372.    nothing much to worry about though.
  373.  
  374.    Checks to see if there is a disc in the drive
  375.  
  376.    i)   If no then it puts the famililar workbench hand up and the Kickstart
  377.         rom number up (1.2/1.3 on a500's at the present).
  378.  
  379.    ii)  If yes then it checks to see if the disc is bootable, by bootable 
  380.         I mean it has either been installed or it has a custom boot-block
  381.         like many demos, commercial programs etc
  382.  
  383.    iii) If the disc is not bootable then the workbench hand is put up
  384.         requesting a bootable disc..
  385.  
  386.    iv)  If a disc IS bootable and it is standard Amiga format then the 
  387.         Amiga firstly reads in a file called 'system-configuration'
  388.         which is found in the DEVS directory (and is the file saved out
  389.         by preferences) - this contains details of the colours that are
  390.         to be used, the pointer colour and shape, printer to be used
  391.         serial parameters etc etc
  392.  
  393.    v)   After loading the system-configuration the Amiga looks to find
  394.         a file called 'Startup-sequence' in the S directory, if it can't
  395.         find it then it exits into CLI. If it does find it then it begins
  396.         running the commands and programs in the list.
  397.  
  398. ---------------------------------------------------------------------------
  399. HINT!
  400.  
  401. Creating YOUR OWN startup-sequences...
  402. --------------------------------------
  403.  
  404. From CLI (using your workbench disc as we have been doing throughout the
  405. tutorial) type 'ed df0:s/startup-sequence'
  406.  
  407. A screen will appear, this is ED a text-editor! Now you can put your own
  408. list of commands/programs...
  409.  
  410. In our example we had created a demo with Spacewriter and had saved it
  411. under the name INTRO.. we can put this in the startup-sequence by typing
  412.  
  413. INTRO and pressing return..
  414.  
  415. This means that the amiga would run the intro and exit (as there were no
  416. more commands to follow) so you could add more commands or even loadwb
  417. and endcli so that the intro is run and the Amiga then loads workbench up,
  418. try it out!
  419.  
  420. To save the sequence press ESCAPE (ESC - top left key) and then 'X' and
  421. return. Make sure the disc you are wanting to write to is in the drive
  422. BEFORE you do this! If the program asks for the Workbech to be put back
  423. in as it sometimes does.. just click on cancel - the sequence will now
  424. be saved into your S directory...
  425.  
  426. --------------------------------------------------------------------------
  427.  
  428. The Disc is now ready to boot!   You have successfully created a bootable
  429. disc from scratch using the dreaded CLI.. it may have been hard work but
  430. hopefully it will encourage you to do more.. and hopefully you have learnt
  431. a few tricks and methods along the way!
  432.  
  433.  
  434.